home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / onlypc / linux / install < prev    next >
Text File  |  1995-08-12  |  10KB  |  207 lines
  1. Installation instructions for XFree86[TM] 3.1.2 Linux distribution [7/23/95]
  2. ----------------------------------------------------------------------------
  3.  
  4. Introduction
  5. ------------
  6.     This is the Linux binary distribution of XFree86 release 3.1.2.
  7. Please read this document carefully before installation, and the included
  8. doc package for detailed configuration information.
  9.  
  10.     The distribution is available in a.out and ELF flavors. Thus,
  11. there are three subdirectories containing files: a.out, elf and common.
  12. Select the flavor you wish to install and grab the specific packages
  13. from the proper subdirectory. Further instructions for installing the
  14. a.out/ELF flavors are given below.
  15.  
  16. Requirements
  17. ------------
  18.     (If using the a.out distribution)
  19.     Linux 1.0, 1.2, or later
  20.     libc-4.5.26, or newer
  21.     libm-4.5.26, or newer
  22.     ld.so-1.4.3, or newer
  23.     shadow-3.3.2 (if using xdm-shdw)
  24.  
  25.     (If using the ELF distribution)
  26.     Linux 1.2, or later
  27.     libc-5.0.9, or newer
  28.     libm-5.0.0, or newer
  29.     ld.so-1.6.6, or newer
  30.  
  31.     This distribution was tested using Linux 1.2.1 and should work
  32. without problems on all versions 1.0, 1.2, and later. Kernel networking
  33. support is required, although each server will work without TCP support
  34. (using the "partial network" option). In order to use the XShm extension,
  35. kernel shared memory support is required. All serial and bus mice detected
  36. by the kernel are supported by the servers.
  37.  
  38. Contents
  39. --------
  40.     Both a.out and ELF distributions are composed of the following parts:
  41.  
  42.            name        req/opt description
  43.           X3128514.tgz      R[1]    Server for 8514-based boards.
  44.           X312AGX.tgz      R[1]    Server for AGX-based boards.
  45.           X312Ma32.tgz      R[1]    Server for Mach32-based boards.
  46.           X312Ma64.tgz      R[1]    Server for Mach64-based boards.
  47.           X312Ma8.tgz      R[1]    Server for Mach8-based boards.
  48.           X312Mono.tgz      R[1]    Server for monochrome video modes.
  49.           X312P9K.tgz      R[1]    Server for P9000-based boards.
  50.           X312S3.tgz      R[1]    Server for S3-based boards.
  51.           X312SVGA.tgz      R[1]    Server for Super VGA-based boards.
  52.           X312VGA.tgz      R[1]    Server for VGA/EGA-based boards.
  53.           X312W32.tgz      R[1]    Server for ET4000/W32-based boards.
  54.           X312bin.tgz      R    The rest of the X11R6 binaries.
  55.           X312cfg.tgz      R    Configuration files.
  56.           X312doc.tgz      R    XFree86 documentation and manpages.
  57.           X312fnt.tgz      R    Basic fonts.
  58.           X312inc.tgz      R    Include files.
  59.           X312lib.tgz      R    Shared X libraries and support files.
  60.  
  61.           X312ctrb.tgz      O    Selected contrib programs.
  62.           X312f100.tgz      O    100-dpi screen fonts.
  63.           X312f75.tgz      O    75-dpi screen fonts.
  64.           X312fbig.tgz      O    Large Kanji and other fonts.
  65.           X312fscl.tgz      O    Scaled fonts (Speedo, Type1).
  66.           X312fcyr.tgz      O    Cyrillic fonts.
  67.           X312jdoc.tgz      O    Japanese version of some docs.
  68.           X312lkit.tgz      O[2]    Server linkkit for customization.
  69.           X312man.tgz      O    Manual pages.
  70.           X312pex.tgz      O    PEX binaries, includes and libraries.
  71.           X312slib.tgz      O    Static X libraries and support files.
  72.           X312ubin.tgz      O[3]    Daemons which reside in /usr/bin.
  73.           X312xdms.tgz      O    Shadow password version of xdm.
  74.           X312xtra.tgz      O    Extra XFree86 servers and binaries.
  75.  
  76.       X312alib.tgz      O[4]  A.out shared libs for the ELF distribution.
  77.       X312aslb.tgz      O[4]  A.out static libs for the ELF distribution.
  78.  
  79.     R = Required for basic operation.
  80.     O = Optional.
  81.     1 = Select server required for your board. If you're unsure which
  82.         server to choose, run SuperProbe (in the bin package).
  83.     2 = Use the linkkit to create a server with PEX and/or XIE support.
  84.     3 = Includes rstartd, for the rstart client. Must be installed in /.
  85.     4 = Required for backward a.out compatibility.
  86.  
  87. A.out or ELF?
  88. -------------
  89.     The traditional format of Linux executables and libraries is known
  90. as a.out (the shared libraries are still a.out, although they are also
  91. known as DLL libraries). ELF is a newer format which is much easier to use
  92. and program with, and is standard on many other Unixes. Because of this,
  93. ELF is expected to quickly overtake a.out as the default Linux format.
  94.  
  95.     However, as ELF support is still maturing, the Linux distributions
  96. of XFree86 provide both a.out and ELF versions. The ELF version contains
  97. portions of the a.out libraries so current binaries will run. In addition
  98. the a.out programming libraries are also provided, so external libraries
  99. can continue to be used.
  100.  
  101. Installation
  102. ------------
  103.     The distribution was compiled to reside in /usr/X11R6. The entire
  104. installation takes up about 42Mb. A "normal" installation takes up about 15Mb.
  105. The names of each tarfile has been created to fit onto filesystems with 8.3
  106. filename requirements, but this is not true of the contents.
  107.  
  108.     The installation must be done as root as there are binaries which
  109. must be unpacked setuid-root. Note that setuid-root operation is not required
  110. when using xdm. Each package is tarred up relative to /usr/X11R6 rather than /,
  111. so it's possible to unpack the distribution on another partition and make a
  112. symlink from there to /usr/X11R6.
  113.  
  114.     Each tarfile has been compressed using gzip, so the command
  115. `gunzip < {xxx.tgz} | tar xfBp -' will decompress and untar the file.
  116. At the very least, you will have to unpack all of the required
  117. packages described above. The optional packages can be unpacked now or
  118. later. Note that some toplevel directories will be created with 0777
  119. permissions. This can be fixed by running the following:
  120.     chmod 755 `find /usr/X11R6 -type d -perm 777`
  121.  
  122.     The next step is to configure the server. First, make sure the
  123. symbolic link /usr/X11R6/bin/X points to the correct server. As mentioned
  124. above, if you're unsure about which server to select, run the SuperProbe
  125. program (in /usr/X11R6/bin) which should give you that information.
  126.  
  127.     Then, you have to create a configuration file XF86Config, found in
  128. /usr/X11R6/lib/X11. The distribution provides a sample XF86Config.eg,
  129. which can be used as a starting point. The program xf86config can be
  130. used to generate an XF86Config file in an interactive fashion. If upgrading
  131. from XFree86 2.1, the old Xconfig can be turned into an XF86Config using
  132. the reconfig program, available in the bin package. The new format has been
  133. extensively improved, so read the XF86Config manpages and all documentation
  134. regarding your server. The xvidtune program can prove useful in tuning
  135. video modes for the server.
  136.  
  137.     The X libraries use the dynamic linker, ld.so, which must be
  138. installed. Make sure that /usr/X11R6/lib is one of the entries in
  139. /etc/ld.so.conf, or add it to your LD_LIBRARY_PATH environment variable.
  140. After installing, run ldconfig to update the system with the location of
  141. the new X libraries.
  142.  
  143.     Finally, add /usr/X11R6/bin to your PATH, before the entry for
  144. /usr/X386, if you have one, and add/usr/X11R6/man to your MANPATH.
  145. The command `startx' can be used to start the server and any clients.
  146. Xdm is also available for remote and local logins to the X server.
  147. A shadow-password compatible version of xdm is available, though it
  148. hasn't been tested. Further information on these programs is
  149. available in the manpages.
  150.  
  151. ELF Installation
  152. ----------------
  153.     The ELF distribution is designed to supplant the a.out distribution.
  154. This means that all ELF binaries and libraries can be found in the same
  155. location as their a.out counterparts. The downside is that a bit of special
  156. care is required to support both ELF and a.out on the same system.
  157.  
  158.     We use a similar strategy as employed by the ELF distribution of GCC.
  159. The /usr/X11R6/lib/i486-linuxaout directory contains the a.out shared and
  160. static libraries. To use them, add /usr/X11R6/lib/i486-linuxaout to
  161. /etc/ld.so.conf and run ldconfig.
  162.  
  163.     To minimize the effects of upgrading to ELF, the a.out shared library
  164. stubs (.sa) have been installed in /usr/X11R6/lib. This way one can run the
  165. ELF XFree86 distribution yet still compile with external a.out libraries
  166. mostly without makefile modification.
  167.  
  168. Configuration
  169. -------------
  170.     The precompiled servers were compiled with LBX and ScreenSaver
  171. extensions included, but without PEX or XIE extensions. The linkkit is
  172. provided with all extensions.
  173.  
  174.     All servers have been compiled with all available drivers. Smaller
  175. servers can be generated by selecting minimal options via the linkkit.
  176. The VGA16 and Mono servers were not compiled with dual-head support, but
  177. this option is also available through the linkkit.
  178.  
  179. Compatibility
  180. -------------
  181.     X11R6 is presented as a complete upgrade from X11R5. In particular,
  182. this means that X11R6 shared libraries cannot be used in place of the
  183. X11R5 (old X386) libraries. The major number has been upgraded on all
  184. the shared libraries to reflect this fact.
  185.  
  186.     In order to use old binaries, you must retain the X11R5 libraries.
  187. They can either remain in /usr/X386/lib or you can move them to some other
  188. location, remembering to update the ld.so config file /etc/ld.so.conf and
  189. re-running ldconfig. Old binaries should be compatible with the new X11R6
  190. server.
  191.  
  192.     For instructions about using the ELF distribution with a.out
  193. compatibility, see the ELF Installation instructions above.
  194.  
  195. Sources
  196. -------
  197.     Sources relative to X11R6 PL11 are available from ftp.XFree86.org
  198. under /pub/XFree86/current. The main README provided in the distribution
  199. has detailed information about mirror sites and XFree86 in general.
  200.  
  201.  
  202.     Please report all errors in this distribution and documentation
  203. to me. Thank you.
  204.  
  205. -orest
  206. orestz@eskimo.com
  207.